A port of version 1.1a9 of Marco Piovanelli's TextEdit Replacement WASTE to C
By Dan Crevier (mailto:dan@rhino.harvard.edu)
Release 15
May 26, 1995
Introduction
WASTE is a replacement written by Marco Piovanelli which is World Script aware, and supports more than 32K of text. It is available at <ftp://ghost.dsi.unimi.it/pub2/papers/piovanel/>. It was written in Pascal and contains a library which can be used with a variety of compilers. Before using this C port, you should download the original WASTE distribution and read the included documentation.
I converted WASTE from pascal to C so that a PPC native version could be compiled. My goal was to make it as similar to the original pascal version as possible. The C source is almost exactly the same as the pascal source. This means that when upgrades are made to WASTE, it should be painless to make the same upgrades to the C version, and also, programs that now use the WASTE library. The downside of this is that the C code could have been made slightly better if written differently.
This is a port of version 1.1a9 . Version 1.1 adds many features over 1.0, but is still in alpha testing. However, it seems very stable. There is also a version of CWASTE based on WASTE 1.0.
Using C WASTE
It is simple to convert any project that now uses WASTE to use the C version. It is simply a matter of using the new version of WASTE.h (see below for difference in WASTE.h), and adding all of the C files to the project. If you are using any undocumented routines in WASTE, you might have to remove the word pascal from their prototypes.
The files must be compiled as C, not C++, so if you are using CodeWarrior, make sure you have not turned on the "Activate C++" option. This option makes it so that .c, .cp, and .cpp files all get compiled as C++. With the option off, .c gets compiled as C, and .cp and .cpp get compiled as C++.
The header file WASTEIntf.h should not be used in your source files. It has all of the declarations for the internal workings of WASTE, which are subject to change in future versions. You should continue to only include WASTE.h.
Differences from WASTE
I've tried to minimize the changes to WASTE. There are a few modifications that can be turned on and off in WASTEIntf.h. WASTE.h is now exactly the same as the version included with WASTE1.1a9.
The following features can be optionally included:
• Optimizations in _WERedraw by Mark Alldritt when WEREDRAW_SPEED is defined. It significantly speed up inserting/deleting text by scrolling text on the screen instead of redrawing it. It may have some bugs that cause redrawing programs though.
• If WEPINSCROLL is defined, Chris Thomas's modifications are used to make WEScroll behave like TEPinScroll.
• Optimizations in recalcs by Leonard Rosenthol when WESMARTRECALCSLOP is defined. Only recalcs slops when text is not left justified.
• WEFORCE_2BYTE modification by Dan Crevier. I found that with the new versions of the language kit updaters (1.1.1), GetScriptManagerVariable(smDoubleByte) is returning false for some reason. If WEFORCE_2BYTE is defined, the two-byte flag is always set to true.
• WASTE_NO_RO_CARET modification by Dan Crevier. When defined, the caret is never drawn if weFReadOnly is true.
Internet Config Support
I've added support for cmd-clicking URL's using Internet Config by Quinn. To use it, define WASTE_IC. You also need the IC Programmer's Kit, which is available at:
The tab handling code has been removed from CWASTE and is now in a separate archive called WETabs.
Changes in Release 2
• Fixed a bunch of bugs in the code for dealing with objects.
Changes in Release 3
• Incorporated fix by Martin Fricke in GWorld allocation
• Incorporated fix by Martin Fricke in offscreen drawing
• I added support for tabs in _WEFindLineBreak() so that word breaks are calculated correctly with tabs.
Changes in Release 4
• Fixed small bug in my tab support in _WEFindLineBreak().
Changes in Release 5
• Fixed another bug in my tab support in _WEFindLineBreak().
Changes in Release 6
• Included this documentation file
• Included optimizations in recalcs by Leonard Rosenthol when WESMARTRECALCSLOP is defined. Only recalcs slops when text is justified.
Changes in Release 7
• Updated to WASTE 1.1a5
• Added support for WASTE_DEBUG flag as in pascal verision of WASTE.
Note: There is some code commented out in _WESanityCheck (in WEDebug.c). It seems to crash for some reason. If anyone knows why, let me know. Also, WEAssert doesn't prepend "Assertion Failed: " to the message, mostly due to lazyness on my part.
• Added WEFORCE_2BYTE modification by Dan Crevier. I found that with the new versions of the language kit updaters (1.1.1), GetScriptManagerVariable(smDoubleByte) is returning false for some reason. If WEFORCE_2BYTE is defined, the two-byte flag is always set to true.
• Added WASTE_NO_RO_CARET modification by Dan Crevier. When defined, the caret is never drawn if weFReadOnly is true.
• Added code to _WEContinousStyleRange to make sure _WESetStyle is never called with the object flag, so it is impossible to have WEContinousStyle write beyond the bounds of a TextStyle structure.
• Fixed a bug in Leonard Rosenthal's WESMARTRECALCSLOP code that would cause it to not work with centered or right justified text
• Added WEDRAG_BY_REGION modification by Dan Crevier. Without WEDRAG_BY_REGION #defined, drags are only initiated when the cursor is over the text, but with it defined, drags are started whenever the cursor is anywhere in the highlighted region. This makes a difference if you for example triple click to select a whole line and then try to drag something by clicking somewhere in the highlighted region that is to the right of the text.
• The tab support has been majorly changed due to hooks added to WASTE. All of the tab code is now in WETabs.c. The routine WEInstallTabHooks() will install all of the hooks necessary to use tabs. Unfortunately, I had to add a couple of parameters to the hook functions to be able to support tabs. I had to add Fixed hPos to WEPixelToCharProcPtr and long hPos to WECharToPixelProcPtr. (Yeah, it might have been better to make them the same type...)
• I added some improvements to the tab code by Bert Seltzer, which makes the code work correctly with horizontal scrolling. I haven't tested the code, and there were lots of changes to the tab stuff, so it may not work...
Changes in Release 8
• Fixed bug in _WEDrawObject introduced in release 7.
• Fixed bug in WECharByte introduced in release 8.
Changes in Release 9
• Added extern "C" stuff around prototypes in WETabs.h
• Fixed bug in SLPixelToChar found by Marco
• Removed WEDRAG_BY_REGION modifications -- above bug fix removes the problem
• Fixed a couple of other serious bugs pointed out by Marco, and one I found
Changes in Release 10
• Updated to WASTE1.1a6
• Added WERemoveTSMHandlers routine to work around a problem I've been having when using inline input in a non-WASTE application when a WASTE application is in the background. I added this for myself, so I didn't put anything about it in WASTE.h.
• Fixed a bug in word wrap with tabs. I don't think it will work with text that is horizontally scrolled...
• Hooks for calling tab routines are now exactly the same as in the pascal WASTE (this was a change in WASTE 1.1a6, not my C port).
• WASTE.h is now exactly the same as the version included with WASTE 1.1a6.
• Removed WETabs from archive, to be put in separate archive.
• Should compile with MPW without modifications (thanks to Roger Brown)
Changes in Release 11
• Fixed bug in _WEClickObject pointed out by Michael Kamprath. It wasn't restoring the lock state of the object handle if the click was handled. (bug in port, not in WASTE)
• Fixed bug in inline input code that was creating 0 length style runs -- pointed out by Martin Sladok. (bug in port, not in WASTE)
Changes in Release 12
• Brought up to WASTE 1.1a8. Note: this version now uses UPP's for callback functions and requires changes to code that uses WASTE. Failure to make changes will not give compiler errors, but will crash on the PPC. This change is not specific to CWASTE, but is required for WASTE 1.1a7 or greater. For example, to add a clickloop, you need to do something like:
static WEClickLoopUPP clickLoop = NULL;
if (clickLoop == NULL)
clickLoop = NewWEClickLoopProc(WEClickLoop);
WESetInfo(weClickLoop, (Ptr)&clickLoop, macWE);
Also requires new version of WETabs (1.2).
• Added support for Internet Config (see section above).
Changes in Release 13
5/20/95
• Fixed problem with _WEDrawLines that was making it crash on machines without 32-bit quickdraw (Thanks Jud Spencer).
• Updated to WASTE 1.1a9
• Added #pragma unused() (now supported in CW 6) for function arguments that aren't used. It now compiles with no warning in CW 6.
• Incorporated fix by Peter DiCamillo that fixes a bug that could crashes when dragging to the trash. It will be in the next WASTE.
• Fixed problem that would cause it to crash under System 7.0 (thanks Michael Kamprath).
• Fixed bug with undoing inline input.
Changes in Release 14
5/26/95
• Fixed bug in WENewAction (Thanks Michael Kamprath).
Acknowledgements
Thanks for Marco Piovanelli for writing WASTE and letting me see a C conversion of WASTE that was based on an older version of WASTE and not quite working.
Also, thanks to John Kendall for giving me a version of Marco's C port that he had gotten to work.
Thanks to Martin Fricke for some bug fixes.
Thanks to Mark Alldritt and Leonard Rosenthol for enhancements.
Thanks to Michael Kamprath for bug fixes and the Object Archive.
If you have any questions, or find any bugs, I can be contacted at:
